home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / graphics / condor30.arj / CPAINT.DOC < prev    next >
Text File  |  1993-06-15  |  19KB  |  387 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    CONDOR PAINT
  8.                Copyright 1993 by Larry Mears
  9.                    All Rights Reserved
  10.                    version  1.1
  11.  
  12.  
  13.  
  14.  
  15.  
  16.         Condor Paint is released as Part of Condor v3.0 you can support
  17.         this whole package by sending $15 or what you can stand to
  18.         encourage updates, to:
  19.  
  20.              Larry Mears
  21.              11027 Crestfield Dr.
  22.              Huntsville, AL 35803
  23.  
  24.  
  25.  
  26.     Disclaimer:  There is no gaurantee as to the performance of
  27.              CONDOR PAINT.  The user assumes ALL risks involved
  28.              from the use of CONDOR PAINT.
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                      INDEX
  36.  
  37.     Description   .................................................... 1
  38.  
  39.     Using CPaint  .................................................... 1
  40.  
  41.     The MAIN Menu .................................................... 2
  42.  
  43.     QUIT  ............................................................ 2
  44.  
  45.     FILE  ............................................................ 2
  46.  
  47.     NEW   ............................................................ 2
  48.  
  49.     COLOR ............................................................ 2
  50.  
  51.     DRAW  ............................................................ 3
  52.  
  53.     PLOT  ............................................................ 3
  54.  
  55.     FILL  ............................................................ 3
  56.  
  57.     CIRCLE  .......................................................... 4
  58.  
  59.     RECT    .......................................................... 4
  60.  
  61.     SOLIDS  .......................................................... 4
  62.  
  63.     TEXT    .......................................................... 5
  64.  
  65.     SOUND   .......................................................... 5
  66.  
  67.     UNDO    .......................................................... 5
  68.  
  69.     EXTRA   .......................................................... 5
  70.  
  71.     CPaint Memory    ................................................. 5
  72.  
  73.     PAUSE   .......................................................... 5
  74.  
  75.     PLAY Graphic     ................................................. 5
  76.  
  77.     Position Cursor  ................................................. 6
  78.  
  79.     Last Words       ................................................. 6
  80.  
  81.  
  82.                     - 1 -
  83.  
  84.           Condor Paint ( CPaint ) creates a ascii text file of graphic
  85.     commands in the correct syntax required by the CONDOR.SYS con: device
  86.     driver.  CPaint requires that CONDOR.SYS be installed to function
  87.     correctly.  Since CPaint isn't simply altering screen memeory don't
  88.     expect it to function as other Paint programs you might use.  What
  89.     CPaint is doing for you is a lot harder to accomplish,  it makes a
  90.     command for the action you selected from the menu and creates
  91.     coordinates for that command from the mouse position.  Erasing is
  92.     accomplished by deleting (Undoing) the last command created. CPAINT.EXE
  93.     will look for GFABASIC.OVL when ran,  put this in the same directory
  94.     as CPAINT.EXE or in a included directory in your PATH statement.
  95.     You must have a MOUSE to use CPaint.
  96.  
  97.          You can use CPaint to make online graphics, pictures, art,
  98.     advertisements, comics, BBS menus, whatever you like.  These
  99.     graphics are displayable from DOS with just the TYPE command if
  100.     the CONDOR.SYS is installed, really far out!!!  CPaint will
  101.     check your free memory and adjust it's buffer to that, the more free
  102.     memory you have the bigger more detail CPaint pic you can create.
  103.     CPaint may not be able to load and work with "any"  CONDOR.SYS format
  104.     graphic due to the limitations imposed by the language CPaint was
  105.     written in, CPaint is intended to create and work with CONDOR files
  106.     CPaint has created only.  You can use a text editor and load CPaint
  107.     files to hand edit.  The CONDOR graphics script looks like a bunch
  108.     of letters and numbers, if you refer to the CONDOR.DOC (the manual)
  109.     you will be able to look these these letters (commands) up and see
  110.     what CPaint is doing.  A human is smarter than CPaint any day and can
  111.     out do CPaint with a little effort and a text editor.  The & loop
  112.     command can provide a lot of punch but is to complex for CPaint to
  113.     handle, but YOU can do it!  You can do some really sharp work just
  114.     using CPaint though.
  115.  
  116.          When CPaint is ran from DOS, not recomended to run from WINDOWS,
  117.     you will get the title screen and a note about 2 BUTTON exit.  A
  118.     2 BUTTON EXIT is simply this: PRESS and HOLD the right mouse button
  119.     and while holding down the right mouse button also press the left
  120.     mouse button then release both.  This is used as a EXIT to the
  121.     MAIN MENU in CPaint.  From the title screen however just CLICK on the
  122.     OK button.  The next thing that confronts you is a RESOLUTION
  123.     selection menu.  You must select a resolution the abort won't work
  124.     from here.  The format for instance 320x200x256 means 320 pixels(dots)
  125.     across ( know as the X coordinate ) and 200 pixels tall ( know as the
  126.     Y coordinate ) and the last part means the number of colors, 256 in
  127.     this example, 320x200x256 a VGA mode and requires a VGA graphics card.
  128.  
  129.  
  130.                     - 2 -
  131.  
  132.     The MAIN Menu will now come up.  Here's a breakdown:
  133.  
  134.     QUIT - Exit CPaint, go back to DOS.
  135.  
  136.     FILE - Use this selection to LOAD a CPaint file or SAVE a CPAINT file.
  137.            No backup files are created and if a file name exists already
  138.            it will be over written without warning.  When a file is loaded
  139.            from here the current picture you are drawing will be wiped out.
  140.            The EXIT command takes you back to the MAIN menu.
  141.  
  142.     NEW - This allows you to start a new pic in a different resolution than
  143.           the one selected when CPaint was first ran.  The current picture
  144.           will be wiped out, so remember to SAVE it from the file menu.
  145.           You can select ABORT and go SAVE it first, or maybe you want to
  146.           start with a clean screen and empty buffer in the same resolution
  147.           in effect killing the drawing you were working on, the NEW option
  148.           does this.
  149.  
  150.     COLOR This alters the color you are working with and or changes a
  151.           color to another from the color palette.   The options can vary
  152.           from this selection depending on the resolution you are using.
  153.           A sub menu will pop up from this menu, then you select what you
  154.           want to use the color, POINTS, LINES, FILLS, TEXT, or PALETTE to
  155.           alter the color palette.  After clicking on points, lines, fills,
  156.           or text you will see a color bar, click on the color you want
  157.           to use for the previous selected drawing operation.
  158.  
  159.          If you select PALETTE and are in a CGA mode you are given
  160.           the option to alter FOREGROUND or BACKGROUND color. If you pick
  161.           BACKGROUND then next click on the ALTER button till you get the
  162.           color you want then click on OK.  If you select FOREGROUND
  163.           click on ALTER and then OK when it's what you want.
  164.  
  165.          In 2 color screen modes and modes 320x200x16 and 640x200x16
  166.           the PALETTE option has no effect.  You can not change the
  167.           Palette for these modes.
  168.  
  169.          In the EGA 640x350x16 and VGA 640x480x16 modes when you click
  170.           on PALETTE you will get the options BORDER or SCREEN.  If you
  171.           select BORDER just CLICK on the ALTER button till you get the
  172.           border(outer most screen edge) you like then click on OK.
  173.           If you select SCREEN then click on the color in the color bar
  174.           that you wish to ALTER, then click on ALTER over and over till
  175.           you get what color you desire the click on OK.  You have to
  176.           still reselect COLOR from MAIN and tell what to use this
  177.           new color for POINTS, LINES, FILLS, or TEXT.
  178.  
  179.         If you are using VGA mode 320x200x256 and select PALETTE you
  180.           will see a mesh of 256 colors, click on the one you wish to
  181.           alter, then you will see a slide bar CLICK on the BAR to
  182.           adjust the color level.  Press the RIGHT mouse button to
  183.           toggle to RED, GREEN or BLUE.  Click on OK when you get
  184.           the color mixture you need or do the 2 button exit to abort.
  185.           You still have to reselect the COLOR option from the MAIN menu
  186.           tell CPaint what you want to use this new color for,
  187.           POINTs, LINEs, FILLs, or Text.
  188.  
  189.  
  190.                     - 3 -
  191.  
  192.     DRAW -   You select this function from the MAIN menu to draw lines.
  193.            You should select COLOR first to set a COLOR for the lines
  194.            you will be drawing.  The draw routine is designed to draw
  195.            lines in a flowing motion of the mouse, so sometimes it's a
  196.            little cranky to get the line started.  Move the mouse
  197.            slightly then press the left button to anchor the line,  now
  198.            just move the mouse around till you get the other end point
  199.            of the line where you want it and press the left mouse button
  200.            to make the line permanent.  Once you anchor a line down you
  201.            can change the lines anchor point by hitting the right mouse
  202.            button.  To exit to the main menu you must use the
  203.            2 BUTTON EXIT: press and hold the right mouse button then while
  204.            holding that button also press the left mouse button, then
  205.            release both.
  206.  
  207.     PLOT -   This will plot a point at the location of the mouse pointer
  208.            when the left mouse button it pressed.  You should use the
  209.            COLOR option from the MAIN menu to set the color to use for the
  210.            points you are plotting.  DO NOT use this command to draw with,
  211.            while it's possible it will make your picture really big and a
  212.            lot slower.  I would only use this to plot stars in the sky,
  213.            or hit a few points where a FILL may have missed.  Use the
  214.            2 button exit to get back to the MAIN menu.
  215.  
  216.     FILL -   This fills a area with the Fill COLOR you selected from the
  217.            COLOR menu.  The first four options are a border fill, you
  218.            specify what you want to border the fill with.  This is the
  219.            CURRENTLY selected color for POINTs, LINEs, FILLs, or TEXT.
  220.            This fill can leak out even if just ONE dot is missing in a
  221.            border.  ALL colors within the border are replaced with the
  222.            current FILL color.  The last option in the FILL MENU called
  223.            "Interior Color" produces a different type of fill operation.
  224.            This fill gets the color where the fill begins at and replaces
  225.            ONLY that color with the currently selected FILL color.  The
  226.            range of this fill is to the edge of the color it is replacing.
  227.            To FILL a area just select the BORDER type from the menu then
  228.            click on the area to FILL, a 2 button exit takes you back to the
  229.            MAIN menu.
  230.  
  231.  
  232.                     - 4 -
  233.  
  234.     CIRCLE -   This pulls up a menu with 2 options, Condor Circles and
  235.         Plotted Ovals.  The Condor Circle's color is determined by
  236.         what color is selected for LINEs, although if you are drawing
  237.         a disc the interior color is the selected FILL color.  Condor
  238.         Circles are done internally take just a few bytes to produce
  239.         and are draw very fast, their drawback is that there is no
  240.         aspect ratio, so the best looking Condor Circles drawn will be
  241.         in the 320x200 and 640x480 screen resolutions.  I tried real
  242.         hard to include aspect ratios but dos would always lock up!
  243.         The other option Plotted OVALS will produce a OVAL and there
  244.         by you can have perfect circles in any mode with this command.
  245.         The color of the PLOTTED Oval is the color you select from the
  246.         color MENU for POINTs.  Plotted Ovals are just that CPAINT
  247.         does all the math to figure out the coordinates for each point
  248.         plotted and produces a CONDOR Plot command for each one.  This
  249.         is slow but fast online because the math is already done, BUT
  250.         it is very memory hungry and if the Oval is large the CPaint
  251.         picture    will be very large and that means time. The
  252.         Plotted Oval command should be used only if absolutely needed!
  253.            After you select the type of circle you want to draw just
  254.         move the mouse arrow around and click the left mouse button to
  255.         anchor the center of the circle, then move your mouse up and
  256.         down to set the diameter of the circle.  When you get the size
  257.         circle you want click on the left mouse button to make the
  258.         circle permanent.  If you click the right mouse button you can
  259.         reposition the center of the circle.  To abort or exit the
  260.         the circle drawing do a 2 button exit.
  261.  
  262.     RECT -    RECTANGLES   This will first pull up a menu with 2 options.
  263.         With the first option "PIXELS" you move the mouse arrow
  264.         then click the left button to anchor the upper left corner of
  265.         the rectangle, then you can stretch a rectangle to the size you
  266.         need and click the left mouse button again to make it
  267.         permanent.  A right mouse button click will allow you to
  268.         reposition the upper left corner of the rectangle.  You do the
  269.         2 button exit to get back to the main menu.  The color of the
  270.         PIXEL rectangle is determined by the current LINE color.  if
  271.         you are drawing a SOLID rectangle the interior color is the
  272.         current FILL color.
  273.           The second option for rectangle is the "CHARACTER" option.
  274.         When you click on this you will see a text information line in
  275.         upper left section of the screen.  Move your mouse left and
  276.         right to obtain the ASCII character you want to make the
  277.         rectangle with then click the left mouse button.  Move the
  278.         mouse to put the upper left corner of the rectangle where you
  279.         want it then click the left mouse button.  Now move the mouse
  280.         right, left, up, down to see the four corners of the rectangle.
  281.         When you get it the size you want press the left mouse button.
  282.         It will draw a rectanglar area consisting of the character you
  283.         chose.  This command is great to FILL a large area FAST!
  284.         The ASCII character number 219 is great for this.  You can use
  285.         the slower graphic fill command to catch the edges.  To go to
  286.         the MAIN menu do a 2 button exit.
  287.  
  288.     SOLIDS -   This menu entry selects whether a rectangle or circle will
  289.          be filled using with the current fill color, after a circle or
  290.          rectangle is draw using the current line color.
  291.          The Plotted Oval is not affect by this setting and the
  292.          default setting is HOLLOW at startup.  Just click the
  293.          left mouse button on the setting you want SOLID or HOLLOW.
  294.  
  295.  
  296.                     - 5 -
  297.  
  298.     TEXT -     Selecting this menu entry allows you to type a sentence
  299.          up to 128 characters in length.  You can edit this sentence
  300.          using the ARROW keys and the INSERT and ESC keys.  Hit ENTER
  301.          when you finish typing your sentence.  Use the mouse to
  302.          position this sentence where ever you like and press the
  303.          left mouse button to place your sentence.  The color of the
  304.          text is the currently selected text color set from the COLOR
  305.          menu entry.  To EXIT or abort use the 2 button exit, the
  306.          ESC key only clears the line.
  307.  
  308.     SOUND -   This menu entry allows you to insert canned sound effects
  309.         or music into your graphic.  If you select EFFECTS you will
  310.         get a menu of sound effects, just click on one to hear it.
  311.         To actually place a sound effect into a graphic, just click
  312.         on the one you want then click on ACCEPT.  The MORE entry will
  313.         bring up a alternate menu with different sound effects.
  314.           If you select MUSIC you will be able to point and click on
  315.         a piano keyboard to play mouse music.  To make a tune click
  316.         on RECORD and then click on the piano keys, when done you can
  317.         click on PLAY to hear it.  When you get your tune the way you
  318.         want it click on OK.  You abort a tune by clicking on ABORT.
  319.         You can click on PRACTICE and play all you like for fun.
  320.  
  321.     UNDO -    This menu entry will ERASE the last CONDOR command that
  322.         CPAINT created.  This command may be a visable command or not.
  323.         While you can see a LINE that is not drawn, you can't see a
  324.         color command that is erased.  After chopping the last command
  325.         off in it's buffer CPAINT will have to redisplay the whole
  326.         CONDOR format picture from the beginning to insure that the
  327.         setting or change takes effect.  A word of warning,  if you
  328.         find that you want to erase a PLOTTED OVAL you will only be
  329.         killing one DOT of it at a time.  This can take some time, you
  330.         may want to hand edit it out with a text editor.  A
  331.         Plotted Oval can consist of HUNDREDs of PLOT commands! If you
  332.         hand edit it out watch for the   esc}esc#A   at the end of the
  333.         file and leave that intact.
  334.  
  335.  
  336.     EXTRA -  This entry brings up a sub menu that offers some miscellaneous
  337.            commands and utilities.  Descriptions are as follows:
  338.  
  339.            CPAINT Memory - Displays the Cpaint memory free and the amount
  340.                    of CPAINT memory used.  The amount of memory
  341.                    that CPAINT can use is limited by what is free
  342.                    in the DOS conventional 640K memory.
  343.  
  344.            PAUSE x Sec   - This will create a PAUSE command in the graphic.
  345.                    Move you mouse up and down to vary the length of
  346.                    pause.  Click the left mouse button to accept or
  347.                    do the 2 button EXIT to abort.  Users can ABORT
  348.                    this pause by pressing the CTRL key.
  349.  
  350.            PLAY GRAPHIC  - This will redisplay your drawings from beginning
  351.                    to end.
  352.  
  353.  
  354.                     - 6 -
  355.  
  356.            POSITION CURSOR - Useful for positioning the text cursor below
  357.                    a graphic if you are staying in a graphic mode
  358.                    after drawing.  This is how you would create a
  359.                    BBS menu.  You could have several different BBS
  360.                    menus for each resolution and let the caller
  361.                    select the graphics type at log on, say
  362.                    "CONDOR? C)GA E)GA V)GA <N>o".
  363.                    To place the cursor just move the mouse around
  364.                    and click the left mouse button.
  365.                    A 2 button EXIT will abort this command.
  366.  
  367.     **********************************************************************
  368.     LAST WORDS:  Please pressure your BBS author and terminal authors to
  369.              support this new CONDOR.SYS as a option in their programs.
  370.              Don't let up on them I have made it extremely easy for
  371.              them to do so by making CONDOR a dos CON: device replacing
  372.              ANSI!  All they have to do is use DOS for text output!
  373.                      They have no excuse, tell them that you want DOS screen
  374.                      writes as a option in additon to their current text output.
  375.                      Don't let this thing go!  This is very affordable
  376.                      COMMON GRAPHICS LANGUAGE that ALL dos based BBSs and
  377.              terminals can share, just like they share ANSI now!
  378.              Their is no cost or fee for them to include this. T
  379.                      They can include the  CONDOR.SYS in their package.
  380.                      Interested BBS and terminal authors
  381.              can write me at:
  382.              Larry Mears
  383.              11027 Crestfield Dr.
  384.              Huntsville, Alabama
  385.              35803
  386.  
  387.